home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / r / retten / dlii_024 / dlii.asc next >
Encoding:
Text File  |  1996-11-17  |  12.4 KB  |  361 lines
  1.  
  2. VERY VERY VERY PRELIMINARY MANUAL FOR BETA-TEST VERSIONS OF DL II!
  3.  
  4.             (c) 1987 Simon Poole ALL RIGHTS RESERVED!
  5.  
  6.  
  7.                        DL II User's Guide
  8.  
  9.                          I. Introduction
  10.  
  11. DL II  is  a checkdisk/unerase/diskedit  program  with  following 
  12. functions:
  13.  
  14.           -Disk usage display
  15.           -Check of FAT integrity
  16.           -Check for lost and crosslinked clusters
  17.           -Some disk fix functions
  18.           -Automatic and manual unerase
  19.           -File attribute change
  20.           -Disk editing, file or sector orientated
  21.           -Editing of harddisk bootsector
  22.           
  23. DL II will run on any Atari-ST model in medium or high resolution 
  24. mode, it is completly GEM based.
  25.  
  26. I  (Simon Poole) make no warranty of any kind in respect to  this 
  27. manual  and  the  software described in  this  manual.  The  user 
  28. assumes  any  risk  as to the quality  and  performance  of  this 
  29. product.  In  no  event will I be liable  for  direct,  indirect, 
  30. incidental or consequential damages resulting from any defect  in 
  31. the performance and use of this product.
  32.  
  33. GEM, AES, GEMDOS are trademarks of Digital Research Inc.
  34. Atari, ST, TOS  are trademarks of Atari Co.
  35. MS-DOS is a trademark of Microsoft Inc.
  36.  
  37.                        II. Getting Started
  38.  
  39. II.1 Running DL II
  40.  
  41. Copy  the  files  DLII.PRG and DLII.RSC to a  undamaged  disk  or 
  42. harddisk partition. DL II trys to uses the a filename mask of the 
  43. form DLII*.RSC to search for the resource file,  so it will  load 
  44. the first file fitting this specifcation in the search path.  Try 
  45. this with the german resource file DLIIGER.RSC.
  46.  
  47. To run DL II double click or open DLII.PRG,  if you don't want  a 
  48. automatic  diskcheck performed after  most  operations,  deselect 
  49. Autocheck  in  the  Options menu (the default  value  is  not  to 
  50. perform a diskcheck).
  51.  
  52. II.2 Terminology
  53.  
  54. A  sector is the smallest entity on a disk from the view  of  the 
  55. BIOS (Basic Input Output System),  on the ST a sector is normally 
  56. 512 bytes large. Sectors are numbered from zero (normally the so-
  57. called bootsector) to the maximum amount of sectors on the device 
  58. minus one.
  59.  
  60. A  cluster  is the smallest unit diskspace is  allocated  in  for 
  61. files on the disk by GEMDOS.  On the ST a cluster is normally two 
  62. sectors large.
  63.  
  64. The FAT (File Allocation Table) keeps track of which clusters are 
  65. allocated to which file.
  66.  
  67. For  more  information  on TOS and  GEMDOS  disk  structure  read 
  68. chapter III.
  69.  
  70. II.3 Implementation Restrictions
  71.  
  72. The  current version of DL II will only handle a sector  size  of 
  73. 512  bytes  and a maximum clustersize of  two  sectors,  possibly 
  74. future   versions  will  support  a  clustersize  of  4   (MS-DOS 
  75. harddisks). 
  76.  
  77. II.4 Command Overview
  78.  
  79. The functions of DL II can be divided into three groups: commands 
  80. which  access the disk via the information in the  bootsector  of 
  81. the device,  commands which do not need a correct bootsector  and 
  82. commands that are not disk related.  Do not try to use any of the 
  83. functions  which use the bootsector information on a disk with  a 
  84. corrupted bootsector!
  85.  
  86.      Use bootsector:
  87.           
  88.           Menu Disk:
  89.  
  90.           View/Edit...        View and edit the disk on a  sector 
  91.                               by sector base (see II.5  View/Edit 
  92.                               dialog box).
  93.  
  94.           Menu File:
  95.  
  96.           Files...            Select       files      for       a 
  97.                               following operation (see II.6 Files 
  98.                               dialog box).
  99.  
  100.           Check...            Perform a diskcheck on the current 
  101.                               device.
  102.  
  103.           These commands will also be preceded by a diskcheck, if  
  104.           Autocheck is enabled in the Options menu.
  105.  
  106.      Don't use bootsector:
  107.  
  108.           Menu Disk:
  109.  
  110.           Change Disk...      Change the current device.
  111.  
  112.           View/Edit Bootsector View/Edit the bootsector  of  the 
  113.                               current device.          
  114.  
  115.           If  the  bootsector  of the  current  device  has  been 
  116.           damaged,  it  may be possible to fix it with  the  edit 
  117.           function.           
  118.  
  119.      Non-disk commands:
  120.  
  121.           Menu File:
  122.  
  123.           Chain   to  ReOrg...     Terminate  DL  II  and   start 
  124.                                    ReOrg.PRG,  please consult the 
  125.                                    appendix A.
  126.  
  127.           Quit                     Terminate DL II.
  128.  
  129. II.5 The View/Edit dialog box
  130.  
  131. II.5.0 Overview
  132.  
  133. This dialog box is used by:
  134.      Disk: View/Edit, View/Edit Bootsector
  135.      Files: View/Edit, Unerase
  136. Depending  on the actual function you are using,  some or all  of 
  137. the  buttons will be disabled.  The number in the top right  hand 
  138. corner tells you which logical sector/cluster you are working on. 
  139. The  number is always relativ to sector zero of the current  disk 
  140. or the first cluster of the file.
  141.  
  142. To  leave the View/Edit dialog press <Return> or select  Exit.  A 
  143. point  to note is that in the ASCII display NUL and @ are  mapped 
  144. to  space,  if  you  want to enter these to  characters  use  the 
  145. hexadecimal part of the display.
  146.  
  147. II.5.1 Horizontal slider
  148.  
  149. The   left  and  right  arrows  decrease/increase   the   current 
  150. sector/cluster number by one.  A single click in the grey part of 
  151. the  slider  bar will decrease/increase the  number  by  10.  The 
  152. slider can also be dragged to any position.
  153.  
  154. To position the slider at an absolute position,  double click the 
  155. bar  and enter the sector/cluster number in the dialog  box.  All 
  156. elements in the horizontal slider autorepeat if the  mouse-button 
  157. is pressed for a longer time. 
  158.  
  159. II.5.2 Vertical slider
  160.  
  161. The vertical slider,  bar and arrows work exactlly the same as in 
  162. GEM windows,  with the execption that all elements autorepeat  if 
  163. the mouse-button is pressed for a longer time.
  164.  
  165. II.5.3 Search function
  166.  
  167. A  single click on the search button will call up a  dialog  box, 
  168. where  you can enter the string you want to search for in  normal 
  169. ASCII  form (case sensitive!) or as a hexadecimal  number.  If  a 
  170. match is found, the first character of the string is inverted for 
  171. ten seconds,  a keypress or a mouse click returns you immediatly. 
  172. To  continue  from the current postion double  click  the  search 
  173. button. If no match is found the last partial match is displayed.
  174.  
  175. II.5.4 Copy function
  176.  
  177. To copy a sector/cluster to a different position on the disk/file 
  178. select Copy and enter the new position in the dialog box.
  179.  
  180. II.5.5 Add function
  181.  
  182. The Add button is only used by the file Unerase function,  please 
  183. consult the chapter on that.
  184.  
  185. II.5.6 Editing
  186.  
  187. To  edit  a sector/cluster:  single click in the ASCII  or  hexa-
  188. decimal part of the dialog box, a cursor will appear which can be 
  189. moved with the cursor keys,  text or numbers entered will  effect 
  190. both parts of the display immediatly. Press <Return> to exit from 
  191. edit mode. If you decide not to write to disk the contents of the 
  192. internal  buffer  will  NOT be updated,  so you  can  move  to  a 
  193. different  part of the cluster/sector and carry on with  editing. 
  194. To reread the sector/cluster from disk, double click in the ASCII 
  195. or hexadecimal part of the display. 
  196.  
  197.  
  198. II.6 The File menu
  199.  
  200. II.6.0 Overview
  201.  
  202. II.6.1 The Files dialog box
  203.  
  204. This  dialog  form  works  much the  same  as  the  standard  GEM 
  205. fileselector, differences: all parts of the vertical slider auto-
  206. repeat,  only the actual filename is selectable. To return from a 
  207. subdirectory  (folder) to its parent directory;  select the  '..' 
  208. entry.
  209.  
  210. II.6.2 Chain to ReOrg
  211.  
  212. If  you are using DL II from the GEM-Desktop,  this command  will 
  213. immediatley terminate DL II and start ReOrg.PRG (if ReOrg.PRG  is 
  214. in the current desktop search path).
  215.  
  216. II.6.3 Quit
  217.  
  218. Terminate DL II immediatley.
  219.  
  220. II.7 The File operation dialog
  221.  
  222. II.7.0 Overview 
  223.  
  224. II.7.1 Erase
  225.  
  226. II.7.2 Unerase
  227.  
  228. [Recover would be a better expression]
  229.  
  230. II.7.3 Edit entry
  231.  
  232. II.7.4 Show fragmentation
  233.  
  234. II.7.5 View/Edit
  235.  
  236. II.7.6 Next and Previous buttons
  237.  
  238.  
  239. II.8 The Disk menu
  240.  
  241. II.8.0 Overview
  242.  
  243. II.8.1 Check
  244.  
  245. Selecting  the Check command will start a check of all the  files 
  246. and directories on the current drive, things that are checked: 
  247.  
  248.      -lost clusters (clusters that are marked as used, but do not  
  249.       belong to a file or directory)
  250.  
  251.      -crosslinked  clusters  (clusters  that  are  used  by   two 
  252.       different files)
  253.  
  254.      -bad directory entries (zero length files, first cluster out 
  255.       of range)
  256.  
  257.      -other catastropic errors in file allocation
  258.      
  259. Once the check is finished a dialog form will show the results of 
  260. the  operation.  If  DL II finds something wrong  with  the  disk 
  261. structure,  it will show that in this dialog.  If DL II  can  fix 
  262. the problem, the Fix button will be enabled. To get a printout of 
  263. the results, select the Protocol button. You will notice that bad 
  264. directory  entries  to not cause the Fix button  to  be  enabled, 
  265. please  use  the  Protocol option to find  out  what  is  causing 
  266. trouble and delete the approbiate file if necessary.
  267.  
  268. The format of the Protocol file list is:
  269.  
  270.      Filename Attribute Start-Cluster Filesize Error-Message
  271.  
  272. The Fix command will truncate files to avoid crosslinked clusters 
  273. and generate files of the form 99999999.FIX (where 99999999 is an 
  274. unique number) in the root directory out of lost clusters.  Since 
  275. only unused (and not deleted) entries are used,  there is a limit 
  276. to  the  number  of files that can  be  generated.  If  you  have 
  277. problems  with this,  you can change deleted entries into  unused 
  278. entries by changing the first letter of the filename from $E5 (σ) 
  279. to $00, but be careful this also marks the end of used entries in 
  280. the directory!
  281.    
  282.  
  283. IMPORTANT: 
  284.  
  285. DON'T USE THE FIX FUNCTION WITHOUT  MAKING AN IMAGE BACKUP OF THE 
  286. DISK FIRST!
  287.  
  288. II.8.2 View/Edit
  289.  
  290. II.8.3 View/Edit Bootsector
  291.  
  292. II.8.4 Change Current Disk
  293.  
  294.  
  295. II.9 The Options menu
  296.  
  297. If Autocheck is enabled every time the current disk is changed or 
  298. a operation is performed which may change the disk,  a  diskcheck 
  299. operation is performed.
  300.  
  301.  
  302.  
  303.                      III. TOS Disk Structure
  304.  
  305. [This part will be interesting, for now have a look at:
  306.  Inside the IBM-PC by Peter Norton]
  307.  
  308.                IV. Everything that DL II can do..
  309.  
  310. [Just a list of everything]
  311.  
  312.  
  313.               Appendix A: ReOrg, a disk reorganizer
  314.  
  315. IMPORTANT: REORG IS NOT A STANDALONE PROGRAM! YOU NEED AT LEAST A 
  316. IMAGE  BACKUP PROGRAM AND A DISKCHECK PROGRAM BEFORE YOU CAN  USE 
  317. IT!
  318.  
  319. IMPORTANT:  ALWAYS,  ALWAYS  MAKE  AN IMAGE BACKUP OF  YOUR  DISK 
  320. BEFORE RUNNING REORG ON IT!
  321.  
  322. ReOrg  improves disk performance on harddisk and floppys  through 
  323. better  placement of subdirectories and there files on  disk  and 
  324. through  defragmentation of the files themselves,  it  will  also 
  325. remove deleted and zero length entries.
  326.  
  327. As the actual reorganizing is NOT an incremental process,  during 
  328. the  time from the start of the reorganization to the end  of  it 
  329. your disk is in a unusable condition (at least from the viewpoint 
  330. of  the  operating system).  This means,  that a  power  failure, 
  331. computer  malfunction,  disk error or program failure during  the 
  332. reorganization will leave you with a corrupted disk!
  333.  
  334. To  run ReOrg backup your disk,  run the diskcheck program on  it 
  335. (DL  II  will work ok) and ONLY run ReOrg after  all  crosslinked 
  336. and lost clusters have been disposed of!  ReOrg has NO protection 
  337. against  incorrect  disks and will probably run into  a  infinite 
  338. loop if you do not take these precautions!
  339.  
  340. After you have run ReOrg and reorganized your disk,  the computer 
  341. will   reboot,   this  is  normal  and  serves  the  purpose   of 
  342. reinitilizing the TOS internal directory tree.    
  343.  
  344. A verbal description of how ReOrg rebulids your disk is:
  345.  
  346.      'Every  (sub)directory  is immediately followed by  all  the 
  347.      files  it  owns,  followed by all the subdirectories  it  is 
  348.      parent of. Using the last sentence recursively, the place of 
  349.      every file on the disk is determined now'
  350.  
  351.      (from the Reformat manual by Jos Wennmacker)   
  352.  
  353. This  also  implys  that after you have  reorganised  your  disk, 
  354. the  amount of clusters ReOrg reports it has to move after a  bit 
  355. of  work on the disk will be quite large,  I would recommend  not 
  356. using  ReOrg again before the performance of your  disk  actually 
  357. drops. 
  358.  
  359.                    Appendix B: Error messages
  360.  
  361.